# 测试类
# 在本章前半部分，你编写了针对单个函数的测试，下面来编写针对
# 类的测试。很多程序中都会用到类，因此证明你的类能够正确工作
# 大有裨益。如果针对类的测试通过了，你就能确信对类所做的改进
# 没有意外地破坏其原有的行为。


# 各种断言方法
# Python在unittest.TestCase 类中提供了很多断言方法。前面说
# 过，断言方法检查你认为应该满足的条件是否确实满足。如果该条
# 件确实满足，你对程序行为的假设就得到了确认，可以确信其中没
# 有错误。如果你认为应该满足的条件实际上并不满足，Python将引
# 发异常。

# 表11-1描述了6个常用的断言方法。使用这些方法可核实返回的值
# 等于或不等于预期的值，返回的值为True 或False ，以及返回的
# 值在列表中或不在列表中。只能在继承unittest.TestCase 的类
# 中使用这些方法，随后来看看如何在测试类时使用其中之一。

# 表11-1	unittest模块中的断言方法
# 方法								用途
# assertEqual(a, b) 			核实a == b
# assertNotEqual(a, b) 			核实a != b
# assertTrue(x) 				核实x 为True
# assertFalse(x) 				核实x 为False
# assertIn(item , list ) 		核实 item 在 list 中
# assertNotIn(item , list ) 	核实 item 不在 list 中


# 一个要测试的类
# 类的测试与函数的测试相似，你所做的大部分工作是测试类中方法
# 的行为。不过还是存在一些不同之处，下面编写一个要测试的类。
# 来看一个帮助管理匿名调查的类：
# survey.py
'''
class AnonymousSurvey:
	"""收集匿名调查问卷的答案。"""
	def __init__(self, question):
		"""存储一个问题，并为存储答案做准备。"""
		self.question = question
		self.responses = []		# 创建了一个空列表，用于存储答案

	def show_question(self):
		"""显示调查问卷。"""
		print(self.question)

	def store_response(self, new_response):
		"""存储单份调查答卷。"""
		self.responses.append(new_response)

	def show_results(self):
		"""显示收集到的所有答卷。"""
		print("Survey results:")
		for response in self.responses:
			print(f"- {response}")
'''

# 为证明AnonymousSurvey 类能够正确工作，编写一个使用它的程序：
# language_survey.py
from survey import AnonymousSurvey 		# 注意导入具体的类名

# 定义一个问题，并创建一个调查
question = "What lanusge did you first learn to speak?"
my_survey = AnonymousSurvey(question)

# 显示问题并存储答案
my_survey.show_question()
print("Enter 'q' at any time to quit.\n")
while True:
	response = input("Language: ")
	if response == 'q':
		break
	my_survey.store_response(response)

# 显示调查结果
# print("\nThank you to everyone who participated in the survey!")
# my_survey.show_results()

# 这个程序定义了一个问题（"What language did you firstlearn to speak? " ），
# 并使用该问题创建了一个AnonymousSurvey 对象。接下来，这个程序调
# 用show_question() 来显示问题，并提示用户输入答案。在收到
# 每个答案的同时将其存储起来。用户输入所有答案（输入q 要求退出）后，
# 调用show_results() 来打印调查结果

# AnonymousSurvey 类可用于进行简单的匿名调查。假设我们将它
# 放在了模块survey 中，并想进行改进：让每位用户都可输入多个
# 答案；编写一个方法，只列出不同的答案并指出每个答案出现了多
# 少次；再编写一个类，用于管理非匿名调查。
# 进行上述修改存在风险，可能影响AnonymousSurvey 类的当前行
# 为。例如，允许每位用户输入多个答案时，可能会不小心修改处理
# 单个答案的方式。要确认在开发这个模块时没有破坏既有行为，可
# 以编写针对这个类的测试。


# 测试AnonymousSurvey 类
# 下面来编写一个测试，对AnonymousSurvey 类的行为的一个方面
# 进行验证：如果用户面对调查问题只提供一个答案，这个答案也能
# 被妥善地存储。为此，我们将在这个答案被存储后，使用方法
# assertIn() 来核实它确实在答案列表中：
# test_survey.py

'''
import unittest
from survey import AnonymousSurvey

class TestAnonymousSurvey(unittest.TestCase):
	"""针对AnonymousSurvey类的测试"""

	def test_store_single_response(self):
		"""测试单个答案会被妥善地存储"""
		question = "What lanusge did you first learn to speak?"
		my_survey = AnonymousSurvey(question)		# 创建待测试类的实例
		my_survey.store_response('English')
		self.assertIn('English', my_survey.responses)
		# 上条语句检测单个答案 English 是否已被存入属性responses列表中

if __name__ == '__main__':
	unittest.main()

'''
# 第一个测试方法验证：调查问题的单个答案被存储后，会包含在调查结果列表中。
# 对于这个方法，一个不错的描述性名称是test_store_single_response()，
# 如果这个测试未通过，我们就能通过输出中的方法名得知，在存储单个调查答案方面存在问题。
# 要测试类的行为，需要创建其实例，使用问题"Whatlanguage did you first learn to speak?"
# 创建一个名为my_survey 的实例，然后使用方法store_response() 存储单个答案English 。
# 接下来，检查English 是否包含在列表my_survey.responses 中，
# 以核实这个答案是否被妥善地存储了


# 上面程序只能收集一个答案的调查，用途不大。下面来核实当用户提供三个答案时，
# 它们也将被妥善地存储。为此，在TestAnonymousSurvey 中再添加一个方法：
'''
import unittest
from survey import AnonymousSurvey

class TestAnonymousSurvey(unittest.TestCase):
	"""针对AnonymousSurvey类的测试"""

	def test_store_single_response(self):
		"""测试单个答案会被妥善地存储"""

		question = "What lanusge did you first learn to speak?"
		my_survey = AnonymousSurvey(question)		# 创建待测试类的实例
		my_survey.store_response('English')
		self.assertIn('English', my_survey.responses)
		# 上条语句检测单个答案 English 是否已被存入属性responses列表中

	def test_store_three_responses(self):
		"""测试3个答案会被妥善地存储"""
		question = "What lanusge did you first learn to speak?"
		my_survey = AnonymousSurvey(question)		# 创建待测试类的实例
		responses = ['English', 'Spanish', 'Mandarin']
		for response in responses:
			my_survey.store_response(response)

		for response in responses:
			self.assertIn(response, my_survey.responses)

if __name__ == '__main__':
	unittest.main()

'''
# 将该方法命名为test_store_three_responses() ，并像对
# test_store_single_response() 所做的一样，在其中创建一个
# 调查对象。定义一个包含三个不同答案的列表，再对其中
# 每个答案调用store_response() 。存储这些答案后，使用一个循
# 环来确认每个答案都包含在my_survey.responses 中。
# 再次运行test_survey.py时，两个测试（针对单个答案的测试和针对
# 三个答案的测试）都通过了
# 前述做法的效果很好，但这些测试有些重复的地方。下面使
# 用unittest 的另一项功能来提高其效率。



# 方法setUp()
# 在前面的test_survey.py中，我们在每个测试方法中都创建了一
# 个AnonymousSurvey 实例，并在每个方法中都创建了答
# 案。unittest.TestCase 类包含的方法setUp() 让我们只需创建
# 这些对象一次，就能在每个测试方法中使用。如果在TestCase 类
# 中包含了方法setUp() ，Python将先运行它，再运行各个以test_
# 打头的方法。这样，在你编写的每个测试方法中，都可使用在方法
# setUp() 中创建的对象。
# 下面使用setUp() 来创建一个调查对象和一组答案，供方法
# test_store_single_response() 和
# test_store_three_responses() 使用：

import unittest
from survey import AnonymousSurvey

class TestAnonymousSurvey(unittest.TestCase):
	"""针对AnonymousSurvey类的测试"""

	def setUp(self):
		"""创建一个调查对象和一组答案，供使用的测试方法使用"""

		question = "What lanusge did you first learn to speak?"
		self.my_survey = AnonymousSurvey(question)		# 创建待测试类的实例
		self.responses = ['English', 'Spanish', 'Mandarin']

	def test_store_single_responses(self):
		"""测试单个答案会被妥善地存储"""
		self.my_survey.store_response(self.responses[0])
		self.assertIn(self.responses[0], self.my_survey.responses)

	def test_store_three_responses(self):
		"""测试三个答案会被妥善地存储"""
		for response in self.responses:
			self.my_survey.store_response(response)
		for response in self.responses:
			self.assertIn(response, self.my_survey.responses)

if __name__ == '__main__':
	unittest.main()

# 方法setUp() 做了两件事情：创建一个调查对象,以及创建一个答案列表.
# 存储这两样东西的变量名包含前缀self（即存储在属性中），
# 因此可在这个类的任何地方使用。这让两个测试方法都更简单，
# 因为它们都不用创建调查对象和答案了。方法test_store_single_response()
# 核实self.responses 中的第一个答案self.responses[0] 被妥善地存储，
# 而方法test_store_three_response() 核实self.responses 中的全部
# 三个答案都被妥善地存储。
# 再次运行test_survey.py时，这两个测试也都通过了。如果要扩
# 展AnonymousSurvey ，使其允许每位用户输入多个答案，这些测
# 试将很有用。修改代码以接受多个答案后，可运行这些测试，确认
# 存储单个答案或一系列答案的行为未受影响。
# 测试自己编写的类时，方法setUp() 让测试方法编写起来更容易：
# 可在setUp() 方法中创建一系列实例并设置其属性，再在测试方法
# 中直接使用这些实例。相比于在每个测试方法中都创建实例并设置
# 其属性，这要容易得多。

# 注意 　运行测试用例时，每完成一个单元测试，Python都打印
# 一个字符：测试通过时打印一个句点，测试引发错误时打印一
# 个E ，而测试导致断言失败时则打印一个F 。这就是你运行测
# 试用例时，在输出的第一行中看到的句点和字符数量各不相同
# 的原因。如果测试用例包含很多单元测试，需要运行很长时
# 间，就可通过观察这些结果来获悉有多少个测试通过了。
